home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / xkibitz.1 < prev    next >
Encoding:
Text File  |  1995-07-26  |  8.8 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      XXXXKKKKIIIIBBBBIIIITTTTZZZZ((((1111))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((00006666 OOOOccccttttoooobbbbeeeerrrr 1111999999994444))))       XXXXKKKKIIIIBBBBIIIITTTTZZZZ((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           xkibitz - allow multiple people to interact in an xterm
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           xxxxkkkkiiiibbbbiiiittttzzzz [ _x_k_i_b_i_t_z-_a_r_g_s ] [ _p_r_o_g_r_a_m _p_r_o_g_r_a_m-_a_r_g_s... ]
  13.  
  14.      IIIINNNNTTTTRRRROOOODDDDUUUUCCCCTTTTIIIIOOOONNNN
  15.           xxxxkkkkiiiibbbbiiiittttzzzz allows users in separate xterms to share one shell
  16.           (or any program that runs in an xterm).  Uses include:
  17.  
  18.                o+   A novice user can ask an expert user for help.
  19.                    Using xxxxkkkkiiiibbbbiiiittttzzzz, the expert can see what the user is
  20.                    doing, and offer advice or show how to do it right.
  21.  
  22.                o+   By running xxxxkkkkiiiibbbbiiiittttzzzz and then starting a full-screen
  23.                    editor, people may carry out a conversation,
  24.                    retaining the ability to scroll backwards, save the
  25.                    entire conversation, or even edit it while in
  26.                    progress.
  27.  
  28.                o+   People can team up on games, document editing, or
  29.                    other cooperative tasks where each person has
  30.                    strengths and weaknesses that complement one
  31.                    another.
  32.  
  33.                o+   If you want to have a large number of people do an
  34.                    on-line code walk-through, you can sit two in front
  35.                    of each workstation, and then connect them all
  36.                    together while you everyone looks at code together
  37.                    in the editor.
  38.  
  39.      UUUUSSSSAAAAGGGGEEEE
  40.           To start xxxxkkkkiiiibbbbiiiittttzzzz, one user (the master) runs xkibitz with no
  41.           arguments.
  42.  
  43.           xxxxkkkkiiiibbbbiiiittttzzzz starts a new shell (or another program, if given on
  44.           the command line).  The user can interact normally with the
  45.           shell, or upon entering an escape (described when xkibitz
  46.           starts) can add users to the interaction.
  47.  
  48.           To add users, enter "+ display" where display is the X
  49.           display name.  If there is no ":X.Y" in the display name,
  50.           ":0.0" is assumed.  The master user must have permission to
  51.           access each display.  Each display is assigned a tag - a
  52.           small integer which can be used to reference the display.
  53.  
  54.           To show the current tags and displays, enter "=".
  55.  
  56.           To drop a display, enter "- tag" where tag is the display's
  57.           tag according to the "=" command.
  58.  
  59.           To return to the shared shell, enter "return".  Then the
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 7/23/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXKKKKIIIIBBBBIIIITTTTZZZZ((((1111))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((00006666 OOOOccccttttoooobbbbeeeerrrr 1111999999994444))))       XXXXKKKKIIIIBBBBIIIITTTTZZZZ((((1111))))
  71.  
  72.  
  73.  
  74.           keystrokes of all users become the input of the shell.
  75.           Similarly, all users receive the output from the shell.
  76.  
  77.           To terminate xxxxkkkkiiiibbbbiiiittttzzzz it suffices to terminate the shell
  78.           itself.  For example, if any user types ^D (and the shell
  79.           accepts this to be EOF), the shell terminates followed by
  80.           xxxxkkkkiiiibbbbiiiittttzzzz.
  81.  
  82.           Normally, all characters are passed uninterpreted.  However,
  83.           in the escape dialogue the user talks directly to the
  84.           xxxxkkkkiiiibbbbiiiittttzzzz interpreter.  Any EEEExxxxppppeeeecccctttt(1) or TTTTccccllll(3) commands may
  85.           also be given.  Also, job control may be used while in the
  86.           interpreter, to, for example, suspend or restart xxxxkkkkiiiibbbbiiiittttzzzz.
  87.  
  88.           Various processes can produce various effects.  For example,
  89.           you can emulate a multi-way write(1) session with the
  90.           command:
  91.  
  92.                xkibitz sleep 1000000
  93.  
  94.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  95.           xxxxkkkkiiiibbbbiiiittttzzzz understands a few special arguments which should
  96.           appear before the _p_r_o_g_r_a_m name (if given).  Each argument
  97.           should be separated by whitespace.  If the arguments
  98.           themselves takes arguments, these should also be separated
  99.           by whitespace.
  100.  
  101.           ----eeeessssccccaaaappppeeee sets the escape character.  The default escape
  102.           character is ^].
  103.  
  104.           ----ddddiiiissssppppllllaaaayyyy adds a display much like the "+" command.  Multiple
  105.           -display flags can be given.  For example, to start up
  106.           xkibitz with three additional displays:
  107.  
  108.                xkibitz -display mercury -display fox -display
  109.           dragon:1.0
  110.  
  111.  
  112.      CCCCAAAAVVVVEEEEAAAATTTTSSSS
  113.           Due to limitations in both X and UNIX, resize propagation is
  114.           weak.
  115.  
  116.           When the master user resizes the xterm, all the other xterms
  117.           are logically resized. Unfortunately, xkibitz cannot force
  118.           the physical xterm size to correspond with the logical xterm
  119.           sizes.
  120.  
  121.           The other users are free to resize their xterm but their
  122.           sizes are not propagated.  The master can check the logical
  123.           sizes with the "=" command.
  124.  
  125.           Deducing the window size is a non-portable operation.  The
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 7/23/95)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXKKKKIIIIBBBBIIIITTTTZZZZ((((1111))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((00006666 OOOOccccttttoooobbbbeeeerrrr 1111999999994444))))       XXXXKKKKIIIIBBBBIIIITTTTZZZZ((((1111))))
  137.  
  138.  
  139.  
  140.           code is known to work for recent versions of SunOS, AIX,
  141.           Unicos, and HPUX.  Send back mods if you add support for
  142.           anything else.
  143.  
  144.      EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  145.           The environment variable SHELL is used to determine and
  146.           start a shell, if no other program is given on the command
  147.           line.
  148.  
  149.           If the environment variable DISPLAY is defined, its value is
  150.           used for the display name of the xxxxkkkkiiiibbbbiiiittttzzzz master (the display
  151.           with tag number 0). Otherwise this name remains empty.
  152.  
  153.           Additional arguments may be passed to new xterms through the
  154.           environment variable XKIBITZ_XTERM_ARGS.  For example, to
  155.           create xterms with a scrollbar and a green pointer cursor:
  156.  
  157.                XKIBITZ_XTERM_ARGS="-sb -ms green"
  158.                export XKIBITZ_XTERM_ARGS
  159.  
  160.           (this is for the Bourne shell - use whatever syntax is
  161.           appropriate for your favorite shell). Any option can be
  162.           given that is valid for the xxxxtttteeeerrrrmmmm command, with the
  163.           exception of ----ddddiiiissssppppllllaaaayyyy, ----ggggeeeeoooommmmeeeettttrrrryyyy and ----SSSS as those are set by
  164.           xxxxkkkkiiiibbbbiiiittttzzzz.
  165.  
  166.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  167.           TTTTccccllll(3), lllliiiibbbbeeeexxxxppppeeeecccctttt(3) kkkkiiiibbbbiiiittttzzzz(1)
  168.           "_E_x_p_l_o_r_i_n_g _E_x_p_e_c_t: _A _T_c_l-_B_a_s_e_d _T_o_o_l_k_i_t _f_o_r _A_u_t_o_m_a_t_i_n_g
  169.           _I_n_t_e_r_a_c_t_i_v_e _P_r_o_g_r_a_m_s" by Don Libes, O'Reilly and Associates,
  170.           January 1995.
  171.           "_k_i_b_i_t_z - _C_o_n_n_e_c_t_i_n_g _M_u_l_t_i_p_l_e _I_n_t_e_r_a_c_t_i_v_e _P_r_o_g_r_a_m_s
  172.           _T_o_g_e_t_h_e_r", by Don Libes, Software - Practice & Experience,
  173.           John Wiley & Sons, West Sussex, England, Vol. 23, No. 5,
  174.           May, 1993.
  175.  
  176.      AAAAUUUUTTTTHHHHOOOORRRR
  177.           Don Libes, National Institute of Standards and Technology
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 7/23/95)
  196.  
  197.  
  198.  
  199.